home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Internet Tools 1993 July / Internet Tools.iso / RockRidge / mail / metamail / contrib / amiga / README.Amiga < prev    next >
Encoding:
Text File  |  1992-11-19  |  12.1 KB  |  317 lines
  1. Johan WidΘn                                     8-Nov-1992
  2. Hugingatan 20
  3. S-195 52  M─RSTA
  4. Sweden
  5.  
  6. Tel: +46 8 59 120 120
  7. Email: jw@jwdata.se
  8.  
  9.  
  10. This is a port of metamail version 2.4 to the Commodore Amiga. The current
  11. version has only been tested with Amiga OS 2.0, but there should not be any
  12. problems with 1.3.
  13.  
  14. Ported programs: ezview, mailto, metamail, mmencode, richtext, splitmail.
  15.  
  16.  
  17. Other files that you need
  18. =========================
  19.  
  20. The programs expect to find configuration information in
  21.     the environment
  22.   or in
  23.     S:UUConfig
  24.   or in
  25.     UULIB:Config                (Take a look at UULIB/Config.sample)
  26.  
  27. metamail and mailto relies on a configuration file called
  28.     UULIB:mailcap
  29. A sample mailcap file can be found in UULIB/mailcap
  30.  
  31. metamail and mailto provide the multimedia capability by calling other
  32. programs. These programs are speified in UULIB:mailcap. Most of these
  33. programs are not provided here. You will have to get them some other way.
  34. You will for instance need a program that can display pictures encoded
  35. in the GIF format. I will give suggestions for such programs but many others
  36. will work fine or better.
  37.  
  38.     uulib:seq
  39. A file used by Dillon UUCP to keep a unique sequence number. This file is
  40. expected to exist and contain a number.
  41.  
  42.  
  43. Integration with a normal mail program
  44. ======================================
  45.  
  46. The mail program AmigaElm 1.15 (or later versions) should be able to work
  47. together with metamail. This program is available for ftp on several hosts.
  48.  
  49.  
  50. Environment variables and configuration file info uses by metamail
  51. ==================================================================
  52.  
  53.     Note: the metamail program creates several environment variables with
  54.     names starting with MM_. As the environment under Amiga OS 1.3 is global
  55.     (and no specialcasing has been done for OS 2.0) and stays around after a
  56.     program exits, the setting of some of these variables may affect later
  57.     executions of metamail. If metamail behaves strangely, then take a look at
  58.     how the environment variables env:MM_* are set.
  59.  
  60.     This is usually not a problem, but may occur when one tries out various
  61.     options to metamail.
  62.  
  63.     COLUMNS                     (environment variable)
  64.     -------
  65.         Used by richtect when deciding how to break lines. (default 80)
  66.  
  67.     domain name
  68.     -----------
  69.         Searched for in the configuration files as entry
  70.             DomainName
  71.  
  72.     EDITOR                      (environment variable)
  73.     ------
  74.         The editor used by mailto for the ~e command.
  75.  
  76.     KEYHEADS                    (environment variable)
  77.     --------
  78.         See the metamail manual page.
  79.  
  80.     LINES                       (environment variable)
  81.     -----
  82.         Used by richtext when paging the output. (default 23)
  83.  
  84.     MAILCAPS                    (environment variable)
  85.     --------
  86.         What mailcap files are to be searched. (default uulib:mailcap)
  87.  
  88.     mail editor
  89.     -----------
  90.         Searched for in the configuration files as entry
  91.             MailEditor
  92.         if the environment variables VISUAL or EDITOR are not set.
  93.  
  94.     METAMAIL_P_DIR              (environment variable)
  95.     --------------
  96.         Directory for storing message fragments of type message/partial.
  97.         (default T:message-parts)
  98.  
  99.     METAMAIL_PAGER              (environment variable)
  100.     --------------
  101.         Used by metamail to page output. (default more)
  102.  
  103.     MM_CHARSET                  (environment variable)
  104.     ----------
  105.         The character set used when composing mail with mailto.
  106.         (default us-ascii)
  107.  
  108.     MM_*                        (environment variable)
  109.     ----
  110.         See the metamail manual page.
  111.  
  112.     node name
  113.     ---------
  114.         Searched for in the configuration files as entry
  115.             NodeName
  116.  
  117.     PAGER                       (environment variable)
  118.     -----
  119.         Used by mailto to display online help. (default more)
  120.  
  121.     sendmail
  122.     --------
  123.         The program that splitmail invokes when sending mail.
  124.         Searched for in the configuration files as entry
  125.             Sendmail
  126.         (default Sendmail)
  127.  
  128.     SPLITSIZE                   (environment variable)
  129.     ---------
  130.         See the mailto manual page.
  131.  
  132.     TERMINAL_CMD                (environment variable)
  133.     ------------
  134.         See the metamail manual page.
  135.  
  136.     VISUAL                      (environment variable)
  137.     ------
  138.         The editor used by mailto for the ~v command. If not set then the environment
  139.         variable EDITOR will be used. If EDITOR is not set then the UUCP configuration
  140.         variable MailEditor will be used.
  141.  
  142.     user name
  143.     ---------
  144.         This is first looked for in environment variables USERNAME and USER.
  145.         If not found there then the configuration files are searched for
  146.             UserName
  147.  
  148.  
  149. Suggestions for programs to use with metamail and mailto
  150. ========================================================
  151.  
  152. Here are some suggestions of what you can use. If you know of something better
  153. I would like to hear about it so that I can improve the mailcap file in later
  154. releases.
  155.  
  156. audio/basic
  157. -----------
  158.     To play I call a script, playUlawSound, that is provided in AmigaSrc. The
  159.     script calls the programs
  160.         SoundZAP        converts from ulaw audio format to 8SVX audio format
  161.         AGMSPlaySound   plays 8SVX audio format
  162.     SoundZAP and AGMSPlaySound are available from many ftp hosts.
  163.  
  164.     To compose (convert actually) an audio fragment I call svxToUlaw. This
  165.     program is provided in AmigaSrc. The program calls the program
  166.         as2ss           converts from 8SVX audio format to ulaw audio format
  167.     as2ss comes from an archive called iff2ulaw.lha. This is available from
  168.     several ftp hosts. However, I had to modify the source, and as there seems
  169.     to be no redistribution restriction I provide the modified iff2ulaw in
  170.     AmigaSrc.
  171.  
  172. image/gif
  173. ---------
  174.     To show a GIF picture I call the program
  175.         GIF_view
  176.     This program is available as archive GIF_view4.lha from several ftp hosts.
  177.  
  178.     To compose (convert actually) a GIF picture I call ilbmToGIF. This program
  179.     is provided in AmigaSrc. The program calls the program
  180.         fbcat
  181.     fbcat is part of the Fuzzy PixMap image manipulation archive. It is
  182.     available on Fish disk 334. There are other program that can be used
  183.     for conversion from IFF ILBM to GIF, for instance: AmigaJPEG_v2.lzh.
  184.     The pbmplus (PBM/PGM/PPM) library, usually called pbm+.lzh, available
  185.     from several ftp hosts has two tools that can be used: ilbmtoppm and
  186.     ppmtogif.
  187.  
  188. image/jpeg
  189. ----------
  190.     To show a JPEG picture I call the script
  191.         showJPEG
  192.     This script in turn calls djpeg, ppmtoilbm and Mostra.
  193.         djpeg           convert from JPEG to PPM
  194.         ppmtoilbm       convert from PPM (or PBM, PBM) to IFF ILBM.
  195.         Mostra          show an IFF ILBM
  196.     djpeg is part of the archive AmigaJPEG_v2.lzh, which is available on
  197.     several ftp hosts.
  198.     ppmtoilbm is part of the pbmplus (PBM/PGM/PPM) library available from
  199.     pc.usl.edu.
  200.     Mostra is available from several ftp hosts. Use whatever viewer suits you.
  201.  
  202. image/pbm
  203. ---------
  204.     To show a PBM picture I call the script
  205.         showPBM
  206.     This script in turn calls ppmtoilbm and Mostra.
  207.         ppmtoilbm       convert from PPM (or PBM, PBM) to IFF ILBM.
  208.         Mostra          show an IFF ILBM
  209.     ppmtoilbm is part of the pbmplus (PBM/PGM/PPM) library, usually called
  210.     pbm+.lzh, which is available from several ftp hosts.
  211.     Mostra is available from several ftp hosts. Use whatever viewer suits you.
  212.  
  213.     The ppmtoilbm program can be excruciatingly slow. I have modified
  214.     ppmtoilbm into the program pnmtoilbm. This program is several times faster
  215.     (up to nine times faster) than ppmtoilbm, for bitmaps and graymaps.
  216.     I have passed the sources on to the Jef Poskanzer and also to Ingo Wilken
  217.     (who supports PBM on the Amiga). If you are interested in the binary or
  218.     the source and can't find it some other way, drop me a line.
  219.         BMS:Pub/pnmtoilbm.lha
  220.     is available via BMS (part of Matt Dillons UUCP distribution) from node
  221.         jwdata.se
  222.  
  223. image/pgm
  224. ---------
  225.     To show a PGM picture I call the script
  226.         showPGM
  227.     This script in turn calls ppmtoilbm and Mostra.
  228.         ppmtoilbm       convert from PPM (or PGM, PBM) to IFF ILBM.
  229.         Mostra          show an IFF ILBM
  230.     ppmtoilbm is part of the pbmplus (PBM/PGM/PPM) library, usually called
  231.     pbm+.lzh, which is available from several ftp hosts.
  232.     Mostra is available from several ftp hosts. Use whatever viewer suits you.
  233.  
  234. image/x-xbitmap
  235. ---------------
  236.     To show an X bitmap I call xbmtopbm, ppmtoilbm, fakePipe and Mostra.
  237.     fakePipe is provided in AmigaSrc.
  238.         xbmtopbm        convert from X11 or X10 bitmap to PBM.
  239.         ppmtoilbm       convert from PPM (or PBM) to IFF ILBM.
  240.         Mostra          show an IFF ILBM
  241.     xbmtopbm and ppmtoilbm are part of the pbmplus (PBM/PGM/PPM) library,
  242.     usually called pbm+.lzh, which is available from several ftp hosts.
  243.     Mostra is available from several ftp hosts. Use whatever viewer suits you.
  244.  
  245. image/x-xwd
  246. -----------
  247.     To show a color X11 or X10 window dump I call the script
  248.         showXWD
  249.     This script in turn calls xwdtoppm, ppmtoilbm and Mostra.
  250.         xwdtopnm        convert from X11 or X10 window dump to PBM, PGM or PPM.
  251.         ppmtoilbm       convert from PPM (or PBM) to IFF ILBM.
  252.         Mostra          show an IFF ILBM
  253.     xwdtopnm and ppmtoilbm are part of the pbmplus (PBM/PGM/PPM) library,
  254.     usually called pbm+.lzh, which is available from several ftp hosts.
  255.     Mostra is available from several ftp hosts. Use whatever viewer suits you.
  256.  
  257.     The script runs one program at a time. This uses less memory than running
  258.     a pipeline. Both xwdtopnm and ppmtoilbm can be quite memory hungry, so this
  259.     is an important consideration.
  260.  
  261. message/partial
  262. ---------------
  263.     The mailtransport system usually sets a limit on the size of messages.
  264.     MIME therefore provides a mechanism for automatic fragmentation and
  265.     reassembly of large messages. Message fragments have type mmessage/partial.
  266.     Reassembly is handled by the program showpartial provided in AmigaSrc.
  267.     Message fragments avaiting reassembly are stored in the directory given
  268.     by the environment variable.
  269.         METAMAIL_P_DIR
  270.  
  271. text/plain
  272. ----------
  273.     To show plain text I call Leggi or Less.
  274.         Leggi           show a text file.
  275.         Less            show a text file.
  276.     Leggi is available on fish disk 669. (NOTE: You must configure Leggi to exit
  277.         when all its windows have been closed. That is: turn off 'Background'.)
  278.     Less is available on fish disk 511. This worked fine under OS 1.3, but I have
  279.     had some troubles with it under OS 2.0 (a wild pointer in the option parsing?).
  280.     Use whatever text displayer you are happy with.
  281.  
  282. text/richtext
  283. -------------
  284.     To show richtext I call the richtext program, which is provided, and then
  285.     I pipe the output from richtext to Leggi or Less.
  286.         Leggi           show a text file.
  287.         Less            show a text file.
  288.     Leggi is available on fish disk 669.
  289.     Less is available on fish disk 511. Use a text viewer that can handle
  290.     ANSI escape sequences for bold, underline etc.
  291.  
  292. application/postscript
  293. ----------------------
  294.     Note: passing received mail to a PostScript previewer is a gigantic
  295.     security hole. You are setting yourself up for say, a virus attack.
  296.  
  297.     To show PostScript I call the post PostScript previewer. A much safer
  298.     thing to do is to send the PostScript to a PostScript printer.
  299.         Post            show a PostScript file.
  300.     Post is available from many ftp hosts.
  301.  
  302.  
  303. Compiler requirements
  304. =====================
  305.  
  306. I have used DICE. Changes for use with other compilers should be small.
  307.  
  308. DICE supports dynamic stack allocation. This means that the programs will not
  309. run out of stack even if the user has set a fairly small stack. If you
  310. recompile with a compiler that does not support dynamic stack allocation you
  311. may have to require a larger stack setting.
  312.  
  313. I have used functions from the library provided with Dillon UUCP-1.15D. So,
  314. you need that library. If you do not have a working popen() or mktemp() you
  315. can use the ones I provide in AmigaSrc/UUCP-1.15D. Note that UUCP-1.15D does
  316. not come with a working popen().
  317.